home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 7 / BBS in a Box - Macintosh - Volume VII (BBS in a Box) (January 1993).iso / Files / Tele / C / CombineFiles.cpt / CombineFiles.docs < prev    next >
Text File  |  1990-07-15  |  6KB  |  129 lines
  1.                             CombineFiles v1.0
  2.  
  3.                             by Mark Kupferman
  4.  
  5.                               Documentation
  6.  
  7.                      Copyright ©1990 Mark Kupferman
  8.  
  9. PURPOSE
  10. This is a quick and dirty program that will combine all of your file
  11. sections whenever it is done. You are then able to allow your users to
  12. download any file available on your system without having to go to the
  13. individual file section.
  14.  
  15. LIMITATIONS
  16. The program does not sort the files in any way...it simply goes through
  17. the list of File Sections you supply and moves all of the references into
  18. a file you specify. I guess you could say that it does sort them by
  19. File Section...Sections that you list first will be the first ones in the
  20. list, while the section you list last will be the last section on the list.
  21. It is suggested that you list your 'uploads' folder first so that it will be
  22. the first thing users will see when listing files (or put it last if you
  23. do a reverse chronological listing).
  24.  
  25. HOMELESSWARE AGREEMENT
  26. This program is Homelessware. That means that if you find that you enjoy
  27. using it, you must buy a homeless person near you lunch of a value no less
  28. than $5.00. Take'em to MacDonalds, the Ritz Carlton, or where ever you like.
  29. If this does not seem tasteful to you, send the $5.00 to Comic Relief or
  30. another organization that helps the homeless. They need the money a lot more
  31. than I do. Under no circumstance are you to just hand the person on the
  32. street $5.00. The goal of this agreement is not to support a drug habit or
  33. get the person drunk.
  34.  
  35. SETTING UP
  36. This program is pretty easy to set up. Please follow these quick easy steps
  37. and you will be combining in no time:
  38.  
  39. Ingredients:    1 Second Sight BBS
  40.                 2 or more file sections (know their paths)
  41.                 1 copy of Combine Files 1.0
  42.                 1 copy of ResEdit
  43.  
  44. <1> Place Combine Files in the same folder as Second Sight.
  45.  
  46. <2> Open Combine Files 1.0 with ResEdit. Go directly to the 'STR#' resource.
  47.  
  48. <3> Open STR# resource #129 labeled 'Filepaths' (or something like that).
  49.  
  50.     You are allowed to specify up to 100 file sections. File sections will
  51.     be added in the order you specify them here. Enter the path and the
  52.     file name of each section here. Leave all of the extra fields blank, but
  53.     be sure not to delete them.
  54.  
  55. <4> Open STR# resource #130 labeled 'Runtime Information'.
  56.  
  57.     This one's pretty simple. In the first field, enter the path and name of
  58.     the program that you want to run when this program is complete. Usually,
  59.     this will be the path and name of your copy of Second Sight. However, if
  60.     you like you can make it part of a Network event. Be aware that this
  61.     program does not read any scheduling files...it will simply run the 
  62.     program specified in the first field of STR# resource #130. If you want
  63.     to know how to make it run with Tabby, send me a message.
  64.  
  65.     Next, the second field needs to contain the name and path of the file
  66.     section you want the program to create....this is the file that contains
  67.     all of the file sections combined.
  68.  
  69. <5> Ignore STR$ resource #128. It means nothing at this point.
  70.  
  71. <6> Using a menu editor of some kind, insert the appropriate commands into
  72.     whatever menu you would like this section to be accessed from.
  73.  
  74. Wasn't that simple?
  75.  
  76. APPLICATIONS
  77. The reason I created this program was so that I could have a combined section
  78. on my board. What I have is a menu that lists the names of all of my file
  79. sections. The user is then able to list and download from any file section
  80. they wish without having to switch from menu to menu. Thus, each 'list' command
  81. would actually list the individual file section being referred to, but the
  82. download command would actually look at the combined file. In the following
  83. example, the menu text is listed on the left, while the data that would go
  84. in the 'optional data' field is on the right.
  85.  
  86.   o/
  87.  /|     Files
  88. _/_\________________________________________________________
  89. <A> Graphics                             | Path to graphics file section
  90. <B> DeskTop Publishing                   | Path to DTP file section
  91. <C> Adult Section                        | Path to adult file section
  92. <E> Telecommunications                   | Path to telecom file section
  93. <F> Text Files                           | path to text file section
  94. <N> New Uploads                          | path to New Uploads file section
  95.  
  96. <D>ownload a file                        | path to combined file section
  97. <U>pload a file                          | path to new uploads section
  98. <S>earch for a file                      | path to combined file section
  99. <I>nfo on a file                         | path to combined file section
  100.  
  101. To see how I have it set up, call the Tao of Telecommunications.
  102.  
  103. SOURCE CODE
  104. The Turbo Pascal source code and resource file have been enclosed for
  105. the curious. Please feel free to make use of anything you find in it,
  106. although there really isn't much to the program. It's pretty short. If
  107. people would find it more useful if the code for the programs I write were
  108. written in Lightspeed Pascal...well, I will be happy to accept any donations
  109. of a Lightspeed Pascal package. Anyone who does send a copy will cover the
  110. shareware fee of all of my programs, including shareware programs yet to
  111. be written.
  112.  
  113. SUPPORT
  114. If you have any questions, comments, feedback, or suggestions, I can be
  115. reached through the following methods:
  116.  
  117. Mark Kupferman
  118. 258 West Newton Street, #3
  119. Boston, MA 02116
  120.  
  121. Voice Phone:     (617) 859-7757
  122. BBS Phone:       (617) 536-6419  Tao of Telecommunications BBS
  123. GEnie:           M.S.K.
  124. America Online:  MSK
  125. InterNet:        mkupferman@lynx.northeastern.edu
  126. BitNet:          mkupferman@lynx.northeastern.edu
  127.  
  128. Preferred method of communications is via my BBS, InterNet or BitNet,
  129. although you may feel free to use any of the above.